<html>
<head><meta charset="utf-8"><title>mdbook localisation · t-community/l10n · Zulip Chat Archive</title></head>
<h2>Stream: <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/index.html">t-community/l10n</a></h2>
<h3>Topic: <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localisation.html">mdbook localisation</a></h3>

<hr>

<base href="https://rust-lang.zulipchat.com">

<head><link href="https://rust-lang.github.io/zulip_archive/style.css" rel="stylesheet"></head>

<a name="195247116"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localisation/near/195247116" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> XAMPPRocky <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localisation.html#195247116">(Apr 24 2020 at 21:32)</a>:</h4>
<p>Hey, I just wrote a patch for mdbook that adds fluent support. I would love to get feedback from anyone here interested in trying it out, since hopefully most people here will be the main users. <a href="https://github.com/rust-lang/mdBook/pull/1201" title="https://github.com/rust-lang/mdBook/pull/1201">https://github.com/rust-lang/mdBook/pull/1201</a></p>



<a name="195264059"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localisation/near/195264059" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localisation.html#195264059">(Apr 25 2020 at 02:45)</a>:</h4>
<p>Definitely interested, will download and give it a try.</p>



<a name="195264066"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localisation/near/195264066" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localisation.html#195264066">(Apr 25 2020 at 02:45)</a>:</h4>
<p>Also curious what would it take to put the text of The Book or The Reference to pontoon, for example.</p>



<a name="195264793"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localisation/near/195264793" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localisation.html#195264793">(Apr 25 2020 at 03:07)</a>:</h4>
<p>It works. Cool~</p>



<a name="195264797"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localisation/near/195264797" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localisation.html#195264797">(Apr 25 2020 at 03:07)</a>:</h4>
<p><a href="/user_uploads/4715/cjA9z2l48Gc3XhhTfJzQAK5E/image.png" title="image.png">image.png</a></p>
<div class="message_inline_image"><a href="/user_uploads/4715/cjA9z2l48Gc3XhhTfJzQAK5E/image.png" title="image.png"><img src="/user_uploads/4715/cjA9z2l48Gc3XhhTfJzQAK5E/image.png"></a></div>



<a name="195264910"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localisation/near/195264910" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localisation.html#195264910">(Apr 25 2020 at 03:10)</a>:</h4>
<p>Found a small bug though, when there're three or more languages (including English), mdBook will panic around line 68 in <code>hbs_renderer.rs</code>.  It seems it mixes different languages when executing <code>strip_prefix</code>, and emitting an error.</p>



<a name="195270922"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localisation/near/195270922" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> XAMPPRocky <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localisation.html#195270922">(Apr 25 2020 at 06:28)</a>:</h4>
<p><span class="user-mention" data-user-id="116458">@Charles Lew</span> If this PR is added it would be relatively trivial to add mdbook projects to pontoon.</p>



<a name="195271776"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localisation/near/195271776" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> XAMPPRocky <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localisation.html#195271776">(Apr 25 2020 at 06:59)</a>:</h4>
<p><span class="user-mention silent" data-user-id="116458">Charles Lew</span> <a href="#narrow/stream/226068-t-community.2Fl10n/topic/mdbook.20localisation/near/195264910" title="#narrow/stream/226068-t-community.2Fl10n/topic/mdbook.20localisation/near/195264910">said</a>:</p>
<blockquote>
<p>Found a small bug though, when there're three or more languages (including English), mdBook will panic around line 68 in <code>hbs_renderer.rs</code>.  It seems it mixes different languages when executing <code>strip_prefix</code>, and emitting an error.</p>
</blockquote>
<p>Thanks for the report! I've pushed up a fix for this.</p>



<a name="195277203"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localisation/near/195277203" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> DPC <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localisation.html#195277203">(Apr 25 2020 at 09:42)</a>:</h4>
<p>co-maintainer of mdbook here.  we have a 0.4 release in the pipeline soon.</p>



<a name="195277345"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localisation/near/195277345" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> XAMPPRocky <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localisation.html#195277345">(Apr 25 2020 at 09:46)</a>:</h4>
<p>Well as written this is a breaking change. It's a relatively small though. Most of the diff is <code>Cargo.lock</code>.</p>



<a name="219514247"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localisation/near/219514247" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> vertexclique <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localisation.html#219514247">(Dec 10 2020 at 18:31)</a>:</h4>
<p>I don't know the latest state of this PR but it seems it needs a rebase. While at it, I would like to discuss with all subteams that how do we want to proceed with this. Since in Turkish subteam there are contributors who would like to write mdbook(and I see that in other subteams have them too), it will be nice to go with either:</p>
<ul>
<li>a directory under <code>project-localization</code> that hosts all mdbooks and deploy them.</li>
<li>or <span class="user-mention" data-user-id="219696">@XAMPPRocky</span> 's PR gets merged and we carry on with fluent + pontoon.<br>
That said, I would like to have some input on that.</li>
</ul>



<a name="219517405"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localisation/near/219517405" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> apiraino <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localisation.html#219517405">(Dec 10 2020 at 18:55)</a>:</h4>
<p><span class="user-mention" data-user-id="223879">@vertexclique</span> one question (kind of meta-question really because I've landed here at a later stage): is this PR part of  larger story about translating the "Rust Book" or just "add localization support to mdbook" which I is the theme of pr <a href="https://github.com/rust-lang/mdBook/pull/1201">https://github.com/rust-lang/mdBook/pull/1201</a></p>



<a name="219517471"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localisation/near/219517471" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> apiraino <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localisation.html#219517471">(Dec 10 2020 at 18:56)</a>:</h4>
<p>and if the latter, what would be the involvement for translators?</p>



<a name="219523570"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localisation/near/219523570" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> vertexclique <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localisation.html#219523570">(Dec 10 2020 at 19:42)</a>:</h4>
<p>It is about translating the rust book, and all other books. So far book translations scattered in different github repositories and different github organizations which makes some things hard, for example there are 2 different unofficial Rust communities in Turkey where they translated some part of the books and they have different repositories for books. This PR can enable using pontoon and everybody works cooperatively from my point of view for every language.</p>
<p>For the latter, if this PR lands, we can open project for every book in Pontoon, so translators can translate over pontoon cooperatively.</p>



<a name="219527155"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localisation/near/219527155" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> apiraino <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localisation.html#219527155">(Dec 10 2020 at 20:09)</a>:</h4>
<p>understood, thanks <span aria-label="thumbs up" class="emoji emoji-1f44d" role="img" title="thumbs up">:thumbs_up:</span></p>



<a name="219543862"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localisation/near/219543862" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> phaazon <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localisation.html#219543862">(Dec 10 2020 at 22:36)</a>:</h4>
<p><span class="user-mention silent" data-user-id="223879">vertexclique</span> <a href="#narrow/stream/226068-t-community.2Fl10n/topic/mdbook.20localisation/near/219514247">said</a>:</p>
<blockquote>
<p>I don't know the latest state of this PR but it seems it needs a rebase. While at it, I would like to discuss with all subteams that how do we want to proceed with this. Since in Turkish subteam there are contributors who would like to write mdbook(and I see that in other subteams have them too), it will be nice to go with either:</p>
<ul>
<li>a directory under <code>project-localization</code> that hosts all mdbooks and deploy them.</li>
<li>or <span class="user-mention silent" data-user-id="219696">XAMPPRocky</span> 's PR gets merged and we carry on with fluent + pontoon.<br>
That said, I would like to have some input on that.</li>
</ul>
</blockquote>
<p>I’m fine with both, even though I’m not a big fan of pontoon honestly (it tries to do too many things at the same time and it doesn’t necessarily do them well — i.e. versioning and discussions)</p>



<a name="219550549"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localisation/near/219550549" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> XAMPPRocky <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localisation.html#219550549">(Dec 10 2020 at 23:57)</a>:</h4>
<p>I don’t have time to continue maintaining that PR back up so someone else would have to pick it up.</p>



<hr><p>Last updated: Aug 07 2021 at 22:04 UTC</p>
</html>